Builder v 2
New worker with minecraft
Programmed by rscott6666
Skins and additional input by Vlad11

 

The Builder builds buildings and will do some light landscaping.
To build the builder block you must place a door in the center
spot and planks on the outside.  
 
The builder waits for you to place a build sign within 30 blocks
of his chest.  The sign must read "Build" on the top line and the
name of the structure to build on the second line.  The following
structures are provided with the mod.  Tower1, SimpleHouse1, SimpleHouse2
SimpleHouse3, Warehouse, BuilderHut, FarmerHut, LumberjackHut,
MinerHut, chalet.  In all cases, it doesn't matter if its upper or lower case.
There are several plans associated with the minecolony mod.
 
The structures are build from .floorplan files which detail how the
house is built.  The .floorplan files are found
in the resources/floorplan folder.
 
The builder needs materials to build the house.  If the floorplan
asks for glass, you must give the builder glass.  If the floorplan
calls for uncut wood, you must give the builder uncut wood...
The builder will look for materials in the other chests if they are nearby.
If the builder cannot locate the required materials, he will wait
back at his chest.  When you get close he will tell you what he needs.  He will also
let you know how much he will need to finish the job.  For example,
"Out of planks 65".  The builder does not pick resources up that
are next to him, he only gets them from chests.
 
If you remove the sign before the builder is finshed, he will stop
building.
 
The builder will do some crafting for you.  But none that require
the furnace.  So uncut wood -> planks will be performed. 
But sand->glass will not.  Wood->planks->sticks->fencepost will
be performed.
 
After each job, the builder returns the unused materials to his
chest.

The builder has a builders hut.  It determines how fast the builder 
places blocks down.  With no hut, the builder places 1 block per time unit.
With a level 1 hut, the builder places 2 blocks per time unit.  With a level 2
hut, the builder places 4 blocks per time unit.

There are a few options that the builder uses in the properties file.

builderRange
  This controls how far the builder looks for BUILD signs, and how far he looks for supplies
  in chests.
builderinfiniteresources
  When this is true, the builder has infinite resources on hand, he doesn't need any resources.  (debugging purposes mainly)
builderInstabuild
  When this is true, the builder places 50 blocks per tick.  (debugging purposes mainly)

Description of the floorplan file format V 1
first line tells you the version of the file format
' single quotes start a comment which ends at the end of the line

v 1          ' file format version 1
3 0 -1       ' how the building is placed relative to the sign
             ' the building is moved 3 to the right, and 0 down.
             ' and one forward

Each block is represented by 2 characters.
..    clear this block
      (two spaces) means leave block alone
ww    wood/planks
uu    uncut wood
gg    glass
cc    cobblestone
SS    sandstone
CC    smoothstone
sa    sand
oo    wool
bb    brick
|1    door facing up
|2    door facing right
|3    door facing down
|4    door facing left
^1    cobblestone stairs, leading up from top
^2    cobblestone stairs, leading up from right
^3    cobblestone stairs, leading up from bottom
^4    cobblestone stairs, leading up from left
v1    wood stairs (also v2-v4)
_w    half height wood
_c    half height cobblestone
_S    half height smoothstone
fp    fencepost
 
 
sample file
v1
3 0 0        ' sign is where the spaces are
....  ....   ' if we put .. where the spaces were, the builder would
..ww|1ww..   ' remove the sign thus cancelling the whole construction
..ww..ww..   
..ww..ww..
..wwwwww..
..........
level        ' level means start next layer/level
..........
..ww  ww..   ' we have to skip the second level of a door
..ww..ww..   ' failure to do so makes the door get destroyed
..ww..ww..
..wwwwww..
..........
level
..........
..cccccc..
..cccccc..
..cccccc..
..cccccc..
..........
 
 
another sample, delivery warehouse
v 1
3 1 0
cccccccccccccc
cccccccccccccc
cccccccccccccc
cccccccccccccc
cccccccccccccc
cccccccccccccc
cccccccccccccc
level 2
 
..ww      ww 
 
 
 
  wwwwwwwwww 
level 3
 
  ww      ww 
 
 
 
  wwwwwwwwww 
level 4
 
  wwwwwwwwww 
  ww      ww 
  ww      ww 
  ww      ww 
  wwwwwwwwww 
level 5
 
  wwwwwwwwww 
  wwwwwwwwww 
  wwwwwwwwww 
  wwwwwwwwww 
  wwwwwwwwww  


Description of the floorplan file format V 2
first line tells you the version of the file format
' single quotes start a comment which ends at the end of the line

v 2          ' file format version 2
structure    ' this is a simple building starting from the ground level
3 0 -1       ' how the building is placed relative to the sign
             ' the building is moved 3 to the right, and 0 down.
             ' and one forward

lexicon      ' the lexicon describes which 2 character symbols mean which block IDs
ne=glowstone ' you can use the string if its unique.
fb=56        ' or a block id
or=cloth,1   ' or a block id with metadata
n1=vines,1,7 ' rotation data is the last argument, experiment at own risk, this is for blocks (like torches/vines) that 
             ' have different metadata depending on which way they face

@default.lexicon    ' read in a default collection of lexicons from this file


base         ' the start of the bottom part of a construction, for structures, only the base is used


Each block is represented by 2 characters.
..    clear this block
      (two spaces) means leave block alone
ww    wood/planks
uu    uncut wood
gg    glass
cc    cobblestone
SS    sandstone
CC    smoothstone
sa    sand
oo    wool
bb    brick
|1    door facing up
|2    door facing right
|3    door facing down
|4    door facing left
^1    cobblestone stairs, leading up from top
^2    cobblestone stairs, leading up from right
^3    cobblestone stairs, leading up from bottom
^4    cobblestone stairs, leading up from left
v1    wood stairs (also v2-v4)
_w    half height wood
_c    half height cobblestone
_S    half height smoothstone
fp    fencepost

WALLS
Instead of a floorplan describing a structure, it could also describe a wall.
Instead of putting structure on the second line, you could place wall, bridge, or 
gwoc.

Walls are floorplans that repeat themselves.  When you place a sign you will
also tell it the length and height of the wall.

build
fence
30 2

This sign would build the fence floorplan, 30 blocks long, 2 blocks high.

The wall structure has 3 parts, the base, the middle, and the top.
The base is placed on the ground, the top is placed at the height level, and
the middle fills in the gap.

BRIDGE/GWOC
The difference between a wall and a GWOC (great wall of china) is how the 
height of the TOP portion is determined.

For the wall type, the top is always height blocks above the base.
For the bridge type, the top stays at the same level no matter what the base does.
For the gwoc type, the top attempts to follow the base, but only adjusts its
height one block at a time.  


